home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 1999 August / SGI Freeware 1999 August.iso / dist / fw_emacs.idb / usr / freeware / info / gnus-2.z / gnus-2
Encoding:
GNU Info File  |  1998-10-28  |  46.0 KB  |  1,485 lines
  1. This is Info file ../info/gnus, produced by Makeinfo-1.63 from the
  2. input file gnus.texi.
  3.  
  4.    This file documents Gnus, the GNU Emacs newsreader.
  5.  
  6.    Copyright (C) 1995,96 Free Software Foundation, Inc.
  7.  
  8.    Permission is granted to make and distribute verbatim copies of this
  9. manual provided the copyright notice and this permission notice are
  10. preserved on all copies.
  11.  
  12.    Permission is granted to copy and distribute modified versions of
  13. this manual under the conditions for verbatim copying, provided also
  14. that the entire resulting derived work is distributed under the terms
  15. of a permission notice identical to this one.
  16.  
  17.    Permission is granted to copy and distribute translations of this
  18. manual into another language, under the above conditions for modified
  19. versions.
  20.  
  21. 
  22. File: gnus,  Node: Sorting Groups,  Next: Group Maintenance,  Prev: Listing Groups,  Up: The Group Buffer
  23.  
  24. Sorting Groups
  25. ==============
  26.  
  27.    The `C-c C-s' (`gnus-group-sort-groups') command sorts the group
  28. buffer according to the function(s) given by the
  29. `gnus-group-sort-function' variable.  Available sorting functions
  30. include:
  31.  
  32. `gnus-group-sort-by-alphabet'
  33.      Sort the group names alphabetically.  This is the default.
  34.  
  35. `gnus-group-sort-by-level'
  36.      Sort by group level.
  37.  
  38. `gnus-group-sort-by-score'
  39.      Sort by group score.
  40.  
  41. `gnus-group-sort-by-rank'
  42.      Sort by group score and then the group level.  The level and the
  43.      score are, when taken together, the group's "rank".
  44.  
  45. `gnus-group-sort-by-unread'
  46.      Sort by number of unread articles.
  47.  
  48. `gnus-group-sort-by-method'
  49.      Sort by alphabetically on the select method.
  50.  
  51.    `gnus-group-sort-function' can also be a list of sorting functions.
  52. In that case, the most significant sort key function must be the last
  53. one.
  54.  
  55.    There are also a number of commands for sorting directly according to
  56. some sorting criteria:
  57.  
  58. `G S a'
  59.      Sort the group buffer alphabetically by group name
  60.      (`gnus-group-sort-groups-by-alphabet').
  61.  
  62. `G S u'
  63.      Sort the group buffer by the number of unread articles
  64.      (`gnus-group-sort-groups-by-unread').
  65.  
  66. `G S l'
  67.      Sort the group buffer by group level
  68.      (`gnus-group-sort-groups-by-level').
  69.  
  70. `G S v'
  71.      Sort the group buffer by group score
  72.      (`gnus-group-sort-groups-by-score').
  73.  
  74. `G S r'
  75.      Sort the group buffer by group level
  76.      (`gnus-group-sort-groups-by-rank').
  77.  
  78. `G S m'
  79.      Sort the group buffer alphabetically by backend name
  80.      (`gnus-group-sort-groups-by-method').
  81.  
  82.    When given a prefix, all these commands will sort in reverse order.
  83.  
  84. 
  85. File: gnus,  Node: Group Maintenance,  Next: Browse Foreign Server,  Prev: Sorting Groups,  Up: The Group Buffer
  86.  
  87. Group Maintenance
  88. =================
  89.  
  90. `b'
  91.      Find bogus groups and delete them
  92.      (`gnus-group-check-bogus-groups').
  93.  
  94. `F'
  95.      Find new groups and process them (`gnus-find-new-newsgroups').  If
  96.      given a prefix, use the `ask-server' method to query the server for
  97.      new groups.
  98.  
  99. `C-c C-x'
  100.      Run all expirable articles in the current group through the expiry
  101.      process (if any) (`gnus-group-expire-articles').
  102.  
  103. `C-c M-C-x'
  104.      Run all articles in all groups through the expiry process
  105.      (`gnus-group-expire-all-groups').
  106.  
  107. 
  108. File: gnus,  Node: Browse Foreign Server,  Next: Exiting Gnus,  Prev: Group Maintenance,  Up: The Group Buffer
  109.  
  110. Browse Foreign Server
  111. =====================
  112.  
  113. `B'
  114.      You will be queried for a select method and a server name.  Gnus
  115.      will then attempt to contact this server and let you browse the
  116.      groups there (`gnus-group-browse-foreign-server').
  117.  
  118.    A new buffer with a list of available groups will appear.  This
  119. buffer will be use the `gnus-browse-mode'.  This buffer looks a bit
  120. (well, a lot) like a normal group buffer, but with one major difference
  121. - you can't enter any of the groups.  If you want to read any of the
  122. news available on that server, you have to subscribe to the groups you
  123. think may be interesting, and then you have to exit this buffer.  The
  124. new groups will be added to the group buffer, and then you can read them
  125. as you would any other group.
  126.  
  127.    Future versions of Gnus may possibly permit reading groups straight
  128. from the browse buffer.
  129.  
  130.    Here's a list of keystrokes available in the browse mode:
  131.  
  132. `n'
  133.      Go to the next group (`gnus-group-next-group').
  134.  
  135. `p'
  136.      Go to the previous group (`gnus-group-prev-group').
  137.  
  138. `SPACE'
  139.      Enter the current group and display the first article
  140.      (`gnus-browse-read-group').
  141.  
  142. `RET'
  143.      Enter the current group (`gnus-browse-select-group').
  144.  
  145. `u'
  146.      Unsubscribe to the current group, or, as will be the case here,
  147.      subscribe to it (`gnus-browse-unsubscribe-current-group').
  148.  
  149. `l'
  150. `q'
  151.      Exit browse mode (`gnus-browse-exit').
  152.  
  153. `?'
  154.      Describe browse mode briefly (well, there's not much to describe,
  155.      is there) (`gnus-browse-describe-briefly').
  156.  
  157. 
  158. File: gnus,  Node: Exiting Gnus,  Next: Group Topics,  Prev: Browse Foreign Server,  Up: The Group Buffer
  159.  
  160. Exiting Gnus
  161. ============
  162.  
  163.    Yes, Gnus is ex(c)iting.
  164.  
  165. `z'
  166.      Suspend Gnus (`gnus-group-suspend').  This doesn't really exit
  167.      Gnus, but it kills all buffers except the Group buffer.  I'm not
  168.      sure why this is a gain, but then who am I to judge?
  169.  
  170. `q'
  171.      Quit Gnus (`gnus-group-exit').
  172.  
  173. `Q'
  174.      Quit Gnus without saving any startup files (`gnus-group-quit').
  175.  
  176.    `gnus-suspend-gnus-hook' is called when you suspend Gnus and
  177. `gnus-exit-gnus-hook' is called when you quit Gnus, while
  178. `gnus-after-exiting-gnus-hook' is called as the final item when exiting
  179. Gnus.
  180.  
  181.    If you wish to completely unload Gnus and all its adherents, you can
  182. use the `gnus-unload' command.  This command is also very handy when
  183. trying to customize meta-variables.
  184.  
  185.    Note:
  186.  
  187.      Miss Lisa Cannifax, while sitting in English class, feels her feet
  188.      go numbly heavy and herself fall into a hazy trance as the boy
  189.      sitting behind her drew repeated lines with his pencil across the
  190.      back of her plastic chair.
  191.  
  192. 
  193. File: gnus,  Node: Group Topics,  Next: Misc Group Stuff,  Prev: Exiting Gnus,  Up: The Group Buffer
  194.  
  195. Group Topics
  196. ============
  197.  
  198.    If you read lots and lots of groups, it might be convenient to group
  199. them hierarchically according to topics.  You put your Emacs groups over
  200. here, your sex groups over there, and the rest (what, two groups or so?)
  201. you put in some misc section that you never bother with anyway.  You can
  202. even group the Emacs sex groups as a sub-topic to either the Emacs
  203. groups or the sex groups--or both!  Go wild!
  204.  
  205.    To get this *fab* functionality you simply turn on (ooh!) the
  206. `gnus-topic' minor mode--type `t' in the group buffer.  (This is a
  207. toggling command.)
  208.  
  209.    Go ahead, just try it.  I'll still be here when you get back.  La de
  210. dum...  Nice tune, that...  la la la...  What, you're back? Yes, and now
  211. press `l'.  There.  All your groups are now listed under `misc'.
  212. Doesn't that make you feel all warm and fuzzy?  Hot and bothered?
  213.  
  214.    If you want this permanently enabled, you should add that minor mode
  215. to the hook for the group mode:
  216.  
  217.      (add-hook 'gnus-group-mode-hook 'gnus-topic-mode)
  218.  
  219. * Menu:
  220.  
  221. * Topic Variables::    How to customize the topics the Lisp Way.
  222. * Topic Commands::     Interactive E-Z commands.
  223. * Topic Topology::     A map of the world.
  224.  
  225. 
  226. File: gnus,  Node: Topic Variables,  Next: Topic Commands,  Up: Group Topics
  227.  
  228. Topic Variables
  229. ---------------
  230.  
  231.    Now, if you select a topic, if will fold/unfold that topic, which is
  232. really neat, I think.
  233.  
  234.    The topic lines themselves are created according to the
  235. `gnus-topic-line-format' variable.  *Note Formatting Variables::.
  236. Elements allowed are:
  237.  
  238. `i'
  239.      Indentation.
  240.  
  241. `n'
  242.      Topic name.
  243.  
  244. `v'
  245.      Visibility.
  246.  
  247. `l'
  248.      Level.
  249.  
  250. `g'
  251.      Number of groups in the topic.
  252.  
  253. `a'
  254.      Number of unread articles in the topic.
  255.  
  256. `A'
  257.      Number of unread articles in the topic and all its subtopics.
  258.  
  259.    Each sub-topic (and the groups in the sub-topics) will be indented
  260. with `gnus-topic-indent-level' times the topic level number of spaces.
  261. The default is `2'.
  262.  
  263.    `gnus-topic-mode-hook' is called in topic minor mode buffers.
  264.  
  265. 
  266. File: gnus,  Node: Topic Commands,  Next: Topic Topology,  Prev: Topic Variables,  Up: Group Topics
  267.  
  268. Topic Commands
  269. --------------
  270.  
  271.    When the topic minor mode is turned on, a new `T' submap will be
  272. available.  In addition, a few of the standard keys change their
  273. definitions slightly.
  274.  
  275. `T n'
  276.      Prompt for a new topic name and create it
  277.      (`gnus-topic-create-topic').
  278.  
  279. `T m'
  280.      Move the current group to some other topic
  281.      (`gnus-topic-move-group').  This command understands the
  282.      process/prefix convention (*note Process/Prefix::.).
  283.  
  284. `T c'
  285.      Copy the current group to some other topic
  286.      (`gnus-topic-copy-group').  This command understands the
  287.      process/prefix convention (*note Process/Prefix::.).
  288.  
  289. `T D'
  290.      Remove a group from the current topic (`gnus-topic-remove-group').
  291.      This command understands the process/prefix convention (*note
  292.      Process/Prefix::.).
  293.  
  294. `T M'
  295.      Move all groups that match some regular expression to a topic
  296.      (`gnus-topic-move-matching').
  297.  
  298. `T C'
  299.      Copy all groups that match some regular expression to a topic
  300.      (`gnus-topic-copy-matching').
  301.  
  302. `T #'
  303.      Mark all groups in the current topic with the process mark
  304.      (`gnus-topic-mark-topic').
  305.  
  306. `T M-#'
  307.      Remove the process mark from all groups in the current topic
  308.      (`gnus-topic-unmark-topic').
  309.  
  310. `RET'
  311. `SPACE'
  312.      Either select a group or fold a topic (`gnus-topic-select-group').
  313.      When you perform this command on a group, you'll enter the group,
  314.      as usual.  When done on a topic line, the topic will be folded (if
  315.      it was visible) or unfolded (if it was folded already).  So it's
  316.      basically a toggling command on topics.  In addition, if you give
  317.      a numerical prefix, group on that level (and lower) will be
  318.      displayed.
  319.  
  320. `T TAB'
  321.      "Indent" the current topic so that it becomes a sub-topic of the
  322.      previous topic (`gnus-topic-indent').  If given a prefix,
  323.      "un-indent" the topic instead.
  324.  
  325. `C-k'
  326.      Kill a group or topic (`gnus-topic-kill-group').
  327.  
  328. `C-y'
  329.      Yank the previously killed group or topic
  330.      (`gnus-topic-yank-group').  Note that all topics will be yanked
  331.      before all groups.
  332.  
  333. `T r'
  334.      Rename a topic (`gnus-topic-rename').
  335.  
  336. `T DEL'
  337.      Delete an empty topic (`gnus-topic-delete').
  338.  
  339. `A T'
  340.      List all groups that Gnus knows about in a topics-ified way
  341.      (`gnus-topic-list-active').
  342.  
  343. 
  344. File: gnus,  Node: Topic Topology,  Prev: Topic Commands,  Up: Group Topics
  345.  
  346. Topic Topology
  347. --------------
  348.  
  349.    So, let's have a look at an example group buffer:
  350.  
  351.      Gnus
  352.        Emacs -- I wuw it!
  353.             3: comp.emacs
  354.             2: alt.religion.emacs
  355.          Naughty Emacs
  356.           452: alt.sex.emacs
  357.             0: comp.talk.emacs.recovery
  358.        Misc
  359.             8: comp.binaries.fractals
  360.            13: comp.sources.unix
  361.  
  362.    So, here we have one top-level topic, two topics under that, and one
  363. sub-topic under one of the sub-topics.  (There is always just one (1)
  364. top-level topic).  This topology can be expressed as follows:
  365.  
  366.      (("Gnus" visible)
  367.       (("Emacs -- I wuw it!" visible)
  368.        (("Naughty Emacs" visible)))
  369.       (("Misc" visible)))
  370.  
  371.    This is in fact how the variable `gnus-topic-topology' would look
  372. for the display above.  That variable is saved in the `.newsrc.eld'
  373. file, and shouldn't be messed with manually--unless you really want to.
  374. Since this variable is read from the `.newsrc.eld' file, setting it in
  375. any other startup files will have no effect.
  376.  
  377.    This topology shows what topics are sub-topics of what topics
  378. (right), and which topics are visible.  Two settings are currently
  379. allowed--`visible' and `invisible'.
  380.  
  381. 
  382. File: gnus,  Node: Misc Group Stuff,  Prev: Group Topics,  Up: The Group Buffer
  383.  
  384. Misc Group Stuff
  385. ================
  386.  
  387. * Menu:
  388.  
  389. * Scanning New Messages:: Asking Gnus to see whether new messages have arrived.
  390. * Group Information::     Information and help on groups and Gnus.
  391. * File Commands::         Reading and writing the Gnus files.
  392.  
  393. `^'
  394.      Enter the server buffer (`gnus-group-enter-server-mode'). *Note
  395.      The Server Buffer::.
  396.  
  397. `a'
  398.      Post an article to a group (`gnus-group-post-news').  The current
  399.      group name will be used as the default.
  400.  
  401. `m'
  402.      Mail a message somewhere (`gnus-group-mail').
  403.  
  404.    Variables for the group buffer:
  405.  
  406. `gnus-group-mode-hook'
  407.      `gnus-group-mode-hook' is called after the group buffer has been
  408.      created.
  409.  
  410. `gnus-group-prepare-hook'
  411.      `gnus-group-prepare-hook' is called after the group buffer is
  412.      generated.  It may be used to modify the buffer in some strange,
  413.      unnatural way.
  414.  
  415. `gnus-permanently-visible-groups'
  416.      Groups matching this regexp will always be listed in the group
  417.      buffer, whether they are empty or not.
  418.  
  419. 
  420. File: gnus,  Node: Scanning New Messages,  Next: Group Information,  Up: Misc Group Stuff
  421.  
  422. Scanning New Messages
  423. ---------------------
  424.  
  425. `g'
  426.      Check the server(s) for new articles.  If the numerical prefix is
  427.      used, this command will check only groups of level ARG and lower
  428.      (`gnus-group-get-new-news').  If given a non-numerical prefix, this
  429.      command will force a total rereading of the active file(s) from the
  430.      backend(s).
  431.  
  432. `M-g'
  433.      Check whether new articles have arrived in the current group
  434.      (`gnus-group-get-new-news-this-group').  The
  435.      `gnus-goto-next-group-when-activating' variable controls whether
  436.      this command is to move point to the next group or not.  It is `t'
  437.      by default.
  438.  
  439. `C-c M-g'
  440.      Activate absolutely all groups (`gnus-activate-all-groups').
  441.  
  442. `R'
  443.      Restart Gnus (`gnus-group-restart').
  444.  
  445.    `gnus-get-new-news-hook' is run just before checking for new news.
  446.  
  447.    `gnus-after-getting-new-news-hook' is run after checking for new
  448. news.
  449.  
  450. 
  451. File: gnus,  Node: Group Information,  Next: File Commands,  Prev: Scanning New Messages,  Up: Misc Group Stuff
  452.  
  453. Group Information
  454. -----------------
  455.  
  456. `M-f'
  457.      Try to fetch the FAQ for the current group
  458.      (`gnus-group-fetch-faq').  Gnus will try to get the FAQ from
  459.      `gnus-group-faq-directory', which is usually a directory on a
  460.      remote machine.  `ange-ftp' will be used for fetching the file.
  461.  
  462. `D'
  463.      Describe the current group (`gnus-group-describe-group').  If given
  464.      a prefix, force Gnus to re-read the description from the server.
  465.  
  466. `M-d'
  467.      Describe all groups (`gnus-group-describe-all-groups').  If given a
  468.      prefix, force Gnus to re-read the description file from the server.
  469.  
  470. `V'
  471.      Display current Gnus version numbers (`gnus-version').
  472.  
  473. `?'
  474.      Give a very short help message (`gnus-group-describe-briefly').
  475.  
  476. `C-c C-i'
  477.      Go to the Gnus info node (`gnus-info-find-node').
  478.  
  479. 
  480. File: gnus,  Node: File Commands,  Prev: Group Information,  Up: Misc Group Stuff
  481.  
  482. File Commands
  483. -------------
  484.  
  485. `r'
  486.      Read the init file (`gnus-init-file', which defaults to `~/.gnus')
  487.      (`gnus-group-read-init-file').
  488.  
  489. `s'
  490.      Save the `.newsrc.eld' file (and `.newsrc' if wanted)
  491.      (`gnus-group-save-newsrc').  If given a prefix, force saving the
  492.      file(s) whether Gnus thinks it is necessary or not.
  493.  
  494. 
  495. File: gnus,  Node: The Summary Buffer,  Next: The Article Buffer,  Prev: The Group Buffer,  Up: Top
  496.  
  497. The Summary Buffer
  498. ******************
  499.  
  500.    A line for each article is displayed in the summary buffer.  You can
  501. move around, read articles, post articles and reply to articles.
  502.  
  503. * Menu:
  504.  
  505. * Summary Buffer Format::       Deciding how the summary buffer is to look.
  506. * Summary Maneuvering::         Moving around the summary buffer.
  507. * Choosing Articles::           Reading articles.
  508. * Paging the Article::          Scrolling the current article.
  509. * Reply Followup and Post::     Posting articles.
  510. * Canceling and Superseding::   "Whoops, I shouldn't have called him that."
  511. * Marking Articles::            Marking articles as read, expirable, etc.
  512. * Limiting::                    You can limit the summary buffer.
  513. * Threading::                   How threads are made.
  514. * Sorting::                     How articles and threads are sorted.
  515. * Asynchronous Fetching::       Gnus might be able to pre-fetch articles.
  516. * Article Caching::             You may store articles in a cache.
  517. * Persistent Articles::         Making articles expiry-resistant.
  518. * Article Backlog::             Having already read articles hang around.
  519. * Saving Articles::             Ways of customizing article saving.
  520. * Decoding Articles::           Gnus can treat series of (uu)encoded articles.
  521. * Article Treatment::           The article buffer can be mangled at will.
  522. * Summary Sorting::             Sorting the summary buffer in various ways.
  523. * Finding the Parent::          No child support? Get the parent.
  524. * Alternative Approaches::      Reading using non-default summaries.
  525. * Tree Display::                A more visual display of threads.
  526. * Mail Group Commands::         Some commands can only be used in mail groups.
  527. * Various Summary Stuff::       What didn't fit anywhere else.
  528. * Exiting the Summary Buffer::  Returning to the Group buffer.
  529.  
  530. 
  531. File: gnus,  Node: Summary Buffer Format,  Next: Summary Maneuvering,  Up: The Summary Buffer
  532.  
  533. Summary Buffer Format
  534. =====================
  535.  
  536. * Menu:
  537.  
  538. * Summary Buffer Lines::     You can specify how summary lines should look.
  539. * Summary Buffer Mode Line:: You can say how the mode line should look.
  540. * Summary Highlighting::     Making the summary buffer all pretty and nice.
  541.  
  542.    Gnus will use the value of the `gnus-extract-address-components'
  543. variable as a function for getting the name and address parts of a
  544. `From' header.  Two pre-defined function exist:
  545. `gnus-extract-address-components', which is the default, quite fast,
  546. and too simplistic solution; and `mail-extract-address-components',
  547. which works very nicely, but is slower.  The default function will
  548. return the wrong answer in 5% of the cases.  If this is unacceptable to
  549. you, use the other function instead.
  550.  
  551.    `gnus-summary-same-subject' is a string indicating that the current
  552. article has the same subject as the previous.  This string will be used
  553. with those specs that require it.  The default is `'.
  554.  
  555. 
  556. File: gnus,  Node: Summary Buffer Lines,  Next: Summary Buffer Mode Line,  Up: Summary Buffer Format
  557.  
  558. Summary Buffer Lines
  559. --------------------
  560.  
  561.    You can change the format of the lines in the summary buffer by
  562. changing the `gnus-summary-line-format' variable.  It works along the
  563. same lines a a normal `format' string, with some extensions.
  564.  
  565.    The default string is `%U%R%z%I%(%[%4L: %-20,20n%]%) %s\n'.
  566.  
  567.    The following format specification characters are understood:
  568.  
  569. `N'
  570.      Article number.
  571.  
  572. `S'
  573.      Subject string.
  574.  
  575. `s'
  576.      Subject if the article is the root, `gnus-summary-same-subject'
  577.      otherwise.
  578.  
  579. `F'
  580.      Full `From' line.
  581.  
  582. `n'
  583.      The name (from the `From' header).
  584.  
  585. `a'
  586.      The name (from the `From' header).  This differs from the `n' spec
  587.      in that it uses `gnus-extract-address-components', which is
  588.      slower, but may be more thorough.
  589.  
  590. `A'
  591.      The address (from the `From' header).  This works the same way as
  592.      the `a' spec.
  593.  
  594. `L'
  595.      Number of lines in the article.
  596.  
  597. `c'
  598.      Number of characters in the article.
  599.  
  600. `I'
  601.      Indentation based on thread level (*note Customizing Threading::.).
  602.  
  603. `T'
  604.      Nothing if the article is a root and lots of spaces if it isn't (it
  605.      pushes everything after it off the screen).
  606.  
  607. `\['
  608.      Opening bracket, which is normally `\[', but can also be `<' for
  609.      adopted articles.
  610.  
  611. `\]'
  612.      Closing bracket, which is normally `\]', but can also be `>' for
  613.      adopted articles.
  614.  
  615. `>'
  616.      One space for each thread level.
  617.  
  618. `<'
  619.      Twenty minus thread level spaces.
  620.  
  621. `U'
  622.      Unread.
  623.  
  624. `R'
  625.      Replied.
  626.  
  627. `i'
  628.      Score as a number.
  629.  
  630. `z'
  631.      Zcore, `+' if above the default level and `-' if below the default
  632.      level.  If the difference between `gnus-summary-default-level' and
  633.      the score is less than `gnus-summary-zcore-fuzz', this spec will
  634.      not be used.
  635.  
  636. `V'
  637.      Total thread score.
  638.  
  639. `x'
  640.      `Xref'.
  641.  
  642. `D'
  643.      `Date'.
  644.  
  645. `M'
  646.      `Message-ID'.
  647.  
  648. `r'
  649.      `References'.
  650.  
  651. `t'
  652.      Number of articles in the current sub-thread.  Using this spec
  653.      will slow down summary buffer generation somewhat.
  654.  
  655. `e'
  656.      A single character will be displayed if the article has any
  657.      children.
  658.  
  659. `u'
  660.      User defined specifier.  The next character in the format string
  661.      should be a letter.  GNUS will call the function
  662.      `gnus-user-format-function-'`X', where `X' is the letter following
  663.      `%u'.  The function will be passed the current header as argument.
  664.      The function should return a string, which will be inserted into
  665.      the summary just like information from any other summary specifier.
  666.  
  667.    The `%U' (status), `%R' (replied) and `%z' (zcore) specs have to be
  668. handled with care.  For reasons of efficiency, Gnus will compute what
  669. column these characters will end up in, and "hard-code" that.  This
  670. means that it is illegal to have these specs after a variable-length
  671. spec.  Well, you might not be arrested, but your summary buffer will
  672. look strange, which is bad enough.
  673.  
  674.    The smart choice is to have these specs as far to the left as
  675. possible.  (Isn't that the case with everything, though?  But I
  676. digress.)
  677.  
  678.    This restriction may disappear in later versions of Gnus.
  679.  
  680. 
  681. File: gnus,  Node: Summary Buffer Mode Line,  Next: Summary Highlighting,  Prev: Summary Buffer Lines,  Up: Summary Buffer Format
  682.  
  683. Summary Buffer Mode Line
  684. ------------------------
  685.  
  686.    You can also change the format of the summary mode bar.  Set
  687. `gnus-summary-mode-line-format' to whatever you like.  Here are the
  688. elements you can play with:
  689.  
  690. `G'
  691.      Group name.
  692.  
  693. `p'
  694.      Unprefixed group name.
  695.  
  696. `A'
  697.      Current article number.
  698.  
  699. `V'
  700.      Gnus version.
  701.  
  702. `U'
  703.      Number of unread articles in this group.
  704.  
  705. `e'
  706.      Number of unselected articles in this group.
  707.  
  708. `Z'
  709.      A string with the number of unread and unselected articles
  710.      represented either as `<%U(+%u) more>' if there are both unread
  711.      and unselected articles, and just as `<%U more>' if there are just
  712.      unread articles and no unselected ones.
  713.  
  714. `g'
  715.      Shortish group name.  For instance, `rec.arts.anime' will be
  716.      shortened to `r.a.anime'.
  717.  
  718. `S'
  719.      Subject of the current article.
  720.  
  721. `u'
  722.      Used-defined spec.
  723.  
  724. `s'
  725.      Name of the current score file.
  726.  
  727. `d'
  728.      Number of dormant articles.
  729.  
  730. `t'
  731.      Number of ticked articles.
  732.  
  733. `r'
  734.      Number of articles that have been marked as read in this session.
  735.  
  736. `E'
  737.      Number of articles expunged by the score files.
  738.  
  739. 
  740. File: gnus,  Node: Summary Highlighting,  Prev: Summary Buffer Mode Line,  Up: Summary Buffer Format
  741.  
  742. Summary Highlighting
  743. --------------------
  744.  
  745. `gnus-visual-mark-article-hook'
  746.      This hook is run after selecting an article.  It is meant to be
  747.      used for highlighting the article in some way.  It is not run if
  748.      `gnus-visual' is `nil'.
  749.  
  750. `gnus-summary-update-hook'
  751.      This hook is called when a summary line is changed.  It is not run
  752.      if `gnus-visual' is `nil'.
  753.  
  754. `gnus-summary-selected-face'
  755.      This is the face (or "font" as some people call it) that is used to
  756.      highlight the current article in the summary buffer.
  757.  
  758. `gnus-summary-highlight'
  759.      Summary lines are highlighted according to this variable, which is
  760.      a list where the elements are on the format `(FORM . FACE)'.  If
  761.      you would, for instance, like ticked articles to be italic and
  762.      high-scored articles to be bold, you could set this variable to
  763.      something like
  764.           (((eq mark gnus-ticked-mark) . italic)
  765.            ((> score default) . bold))
  766.      As you may have guessed, if FORM returns a non-`nil' value, FACE
  767.      will be applied to the line.
  768.  
  769. 
  770. File: gnus,  Node: Summary Maneuvering,  Next: Choosing Articles,  Prev: Summary Buffer Format,  Up: The Summary Buffer
  771.  
  772. Summary Maneuvering
  773. ===================
  774.  
  775.    All the straight movement commands understand the numeric prefix and
  776. behave pretty much as you'd expect.
  777.  
  778.    None of these commands select articles.
  779.  
  780. `G M-n'
  781. `M-n'
  782.      Go to the next summary line of an unread article
  783.      (`gnus-summary-next-unread-subject').
  784.  
  785. `G M-p'
  786. `M-p'
  787.      Go to the previous summary line of an unread article
  788.      (`gnus-summary-prev-unread-subject').
  789.  
  790. `G j'
  791. `j'
  792.      Ask for an article number and then go that article
  793.      (`gnus-summary-goto-article').
  794.  
  795. `G g'
  796.      Ask for an article number and then go the summary line of that
  797.      article (`gnus-summary-goto-subject').
  798.  
  799.    If Gnus asks you to press a key to confirm going to the next group,
  800. you can use the `C-n' and `C-p' keys to move around the group buffer,
  801. searching for the next group to read without actually returning to the
  802. group buffer.
  803.  
  804.    Variables related to summary movement:
  805.  
  806. `gnus-auto-select-next'
  807.      If you are at the end of the group and issue one of the movement
  808.      commands, Gnus will offer to go to the next group.  If this
  809.      variable is `t' and the next group is empty, Gnus will exit
  810.      summary mode and return to the group buffer.  If this variable is
  811.      neither `t' nor `nil', Gnus will select the next group, no matter
  812.      whether it has any unread articles or not.  As a special case, if
  813.      this variable is `quietly', Gnus will select the next group
  814.      without asking for confirmation.  If this variable is
  815.      `almost-quietly', the same will happen only if you are located on
  816.      the last article in the group.  Finally, if this variable is
  817.      `slightly-quietly', the `Z n' command will go to the next group
  818.      without confirmation.  Also *note Group Levels::..
  819.  
  820. `gnus-auto-select-same'
  821.      If non-`nil', all the movement commands will try to go to the next
  822.      article with the same subject as the current.  This variable is not
  823.      particularly useful if you use a threaded display.
  824.  
  825. `gnus-summary-check-current'
  826.      If non-`nil', all the "unread" movement commands will not proceed
  827.      to the next (or previous) article if the current article is unread.
  828.      Instead, they will choose the current article.
  829.  
  830. `gnus-auto-center-summary'
  831.      If non-`nil', Gnus will keep the point in the summary buffer
  832.      centered at all times.  This makes things quite tidy, but if you
  833.      have a slow network connection, or simply do not like this
  834.      un-Emacsism, you can set this variable to `nil' to get the normal
  835.      Emacs scrolling action.  This will also inhibit horizontal
  836.      re-centering of the summary buffer, which might make it more
  837.      inconvenient to read extremely long threads.
  838.  
  839. 
  840. File: gnus,  Node: Choosing Articles,  Next: Paging the Article,  Prev: Summary Maneuvering,  Up: The Summary Buffer
  841.  
  842. Choosing Articles
  843. =================
  844.  
  845.    None of the following movement commands understand the numeric
  846. prefix, and they all select and display an article.
  847.  
  848. `SPACE'
  849.      Select the current article, or, if that one's read already, the
  850.      next unread article (`gnus-summary-next-page').
  851.  
  852. `G n'
  853. `n'
  854.      Go to next unread article (`gnus-summary-next-unread-article').
  855.  
  856. `G p'
  857. `p'
  858.      Go to previous unread article (`gnus-summary-prev-unread-article').
  859.  
  860. `G N'
  861. `N'
  862.      Go to the next article (`gnus-summary-next-article').
  863.  
  864. `G P'
  865. `P'
  866.      Go to the previous article (`gnus-summary-prev-article').
  867.  
  868. `G C-n'
  869.      Go to the next article with the same subject
  870.      (`gnus-summary-next-same-subject').
  871.  
  872. `G C-p'
  873.      Go to the previous article with the same subject
  874.      (`gnus-summary-prev-same-subject').
  875.  
  876. `G f'
  877. `.'
  878.      Go to the first unread article
  879.      (`gnus-summary-first-unread-article').
  880.  
  881. `G b'
  882. `,'
  883.      Go to the article with the highest score
  884.      (`gnus-summary-best-unread-article').
  885.  
  886. `G l'
  887. `l'
  888.      Go to the previous article read (`gnus-summary-goto-last-article').
  889.  
  890. `G p'
  891.      Pop an article off the summary history and go to this article
  892.      (`gnus-summary-pop-article').  This command differs from the
  893.      command above in that you can pop as many previous articles off the
  894.      history as you like.
  895.  
  896.    Some variables that are relevant for moving and selecting articles:
  897.  
  898. `gnus-auto-extend-newsgroup'
  899.      All the movement commands will try to go to the previous (or next)
  900.      article, even if that article isn't displayed in the Summary
  901.      buffer if this variable is non-`nil'.  Gnus will then fetch the
  902.      article from the server and display it in the article buffer.
  903.  
  904. `gnus-select-article-hook'
  905.      This hook is called whenever an article is selected.  By default it
  906.      exposes any threads hidden under the selected article.
  907.  
  908. `gnus-mark-article-hook'
  909.      This hook is called whenever an article is selected.  It is
  910.      intended to be used for marking articles as read.  The default
  911.      value is `gnus-summary-mark-read-and-unread-as-read', and will
  912.      change the mark of almost any article you read to
  913.      `gnus-unread-mark'.  The only articles not affected by this
  914.      function are ticked, dormant, and expirable articles.  If you'd
  915.      instead like to just have unread articles marked as read, you can
  916.      use `gnus-summary-mark-unread-as-read' instead.  It will leave
  917.      marks like `gnus-low-score-mark', `gnus-del-mark' (and so on)
  918.      alone.
  919.  
  920. 
  921. File: gnus,  Node: Paging the Article,  Next: Reply Followup and Post,  Prev: Choosing Articles,  Up: The Summary Buffer
  922.  
  923. Scrolling the Article
  924. =====================
  925.  
  926. `SPACE'
  927.      Pressing `SPACE' will scroll the current article forward one page,
  928.      or, if you have come to the end of the current article, will
  929.      choose the next article (`gnus-summary-next-page').
  930.  
  931. `DEL'
  932.      Scroll the current article back one page
  933.      (`gnus-summary-prev-page').
  934.  
  935. `RET'
  936.      Scroll the current article one line forward
  937.      (`gnus-summary-scroll-up').
  938.  
  939. `A g'
  940. `g'
  941.      (Re)fetch the current article (`gnus-summary-show-article').  If
  942.      given a prefix, fetch the current article, but don't run any of the
  943.      article treatment functions.  This will give you a "raw" article,
  944.      just the way it came from the server.
  945.  
  946. `A <'
  947. `<'
  948.      Scroll to the beginning of the article
  949.      (`gnus-summary-beginning-of-article').
  950.  
  951. `A >'
  952. `>'
  953.      Scroll to the end of the article (`gnus-summary-end-of-article').
  954.  
  955. `A s'
  956.      Perform an isearch in the article buffer
  957.      (`gnus-summary-isearch-article').
  958.  
  959. 
  960. File: gnus,  Node: Reply Followup and Post,  Next: Canceling and Superseding,  Prev: Paging the Article,  Up: The Summary Buffer
  961.  
  962. Reply, Followup and Post
  963. ========================
  964.  
  965. * Menu:
  966.  
  967. * Summary Mail Commands::            Sending mail.
  968. * Summary Post Commands::            Sending news.
  969.  
  970. 
  971. File: gnus,  Node: Summary Mail Commands,  Next: Summary Post Commands,  Up: Reply Followup and Post
  972.  
  973. Summary Mail Commands
  974. ---------------------
  975.  
  976.    Commands for composing a mail message:
  977.  
  978. `S r'
  979. `r'
  980.      Mail a reply to the author of the current article
  981.      (`gnus-summary-reply').
  982.  
  983. `S R'
  984. `R'
  985.      Mail a reply to the author of the current article and include the
  986.      original message (`gnus-summary-reply-with-original').  This
  987.      command uses the process/prefix convention.
  988.  
  989. `S o m'
  990.      Forward the current article to some other person
  991.      (`gnus-summary-mail-forward').
  992.  
  993. `S o p'
  994.      Forward the current article to a newsgroup
  995.      (`gnus-summary-post-forward').
  996.  
  997. `S m'
  998. `m'
  999.      Send a mail to some other person
  1000.      (`gnus-summary-mail-other-window').
  1001.  
  1002. `S D b'
  1003.      If you have sent a mail, but the mail was bounced back to you for
  1004.      some reason (wrong address, transient failure), you can use this
  1005.      command to resend that bounced mail
  1006.      (`gnus-summary-resend-bounced-mail').  You will be popped into a
  1007.      mail buffer where you can edit the headers before sending the mail
  1008.      off again.  If you give a prefix to this command, and the bounced
  1009.      mail is a reply to some other mail, Gnus will try to fetch that
  1010.      mail and display it for easy perusal of its headers.  This might
  1011.      very well fail, though.
  1012.  
  1013. `S D r'
  1014.      Not to be confused with the previous command,
  1015.      `gnus-summary-resend-message' will prompt you for an address to
  1016.      send the current message off to, and then send it to that place.
  1017.      The headers of the message won't be altered--but lots of headers
  1018.      that say `Resent-To', `Resent-From' and so on will be added.  This
  1019.      means that you actually send a mail to someone that has a `To'
  1020.      header that (probably) points to yourself.  This will confuse
  1021.      people.  So, natcherly you'll only do that if you're really eVIl.
  1022.  
  1023.      This command is mainly used if you have several accounts and want
  1024.      to ship a mail to a different account of yours.  (If you're both
  1025.      `root' and `postmaster' and get a mail for `postmaster' to the
  1026.      `root' account, you may want to resend it to `postmaster'.
  1027.      Ordnung muss sein!
  1028.  
  1029. `S O m'
  1030.      Digest the current series and forward the result using mail
  1031.      (`gnus-uu-digest-mail-forward').  This command uses the
  1032.      process/prefix convention (*note Process/Prefix::.).
  1033.  
  1034. `S O p'
  1035.      Digest the current series and forward the result to a newsgroup
  1036.      (`gnus-uu-digest-mail-forward').
  1037.  
  1038. 
  1039. File: gnus,  Node: Summary Post Commands,  Prev: Summary Mail Commands,  Up: Reply Followup and Post
  1040.  
  1041. Summary Post Commands
  1042. ---------------------
  1043.  
  1044.    Commands for posting an article:
  1045.  
  1046. `S p'
  1047. `a'
  1048.      Post an article to the current group (`gnus-summary-post-news').
  1049.  
  1050. `S f'
  1051. `f'
  1052.      Post a followup to the current article (`gnus-summary-followup').
  1053.  
  1054. `S F'
  1055. `F'
  1056.      Post a followup to the current article and include the original
  1057.      message (`gnus-summary-followup-with-original').   This command
  1058.      uses the process/prefix convention.
  1059.  
  1060. `S u'
  1061.      Uuencode a file, split it into parts, and post it as a series
  1062.      (`gnus-uu-post-news'). (*note Uuencoding and Posting::.).
  1063.  
  1064. 
  1065. File: gnus,  Node: Canceling and Superseding,  Next: Marking Articles,  Prev: Reply Followup and Post,  Up: The Summary Buffer
  1066.  
  1067. Canceling Articles
  1068. ==================
  1069.  
  1070.    Have you ever written something, and then decided that you really,
  1071. really, really wish you hadn't posted that?
  1072.  
  1073.    Well, you can't cancel mail, but you can cancel posts.
  1074.  
  1075.    Find the article you wish to cancel (you can only cancel your own
  1076. articles, so don't try any funny stuff).  Then press `C' or `S c'
  1077. (`gnus-summary-cancel-article').  Your article will be
  1078. canceled--machines all over the world will be deleting your article.
  1079.  
  1080.    Be aware, however, that not all sites honor cancels, so your article
  1081. may live on here and there, while most sites will delete the article in
  1082. question.
  1083.  
  1084.    If you discover that you have made some mistakes and want to do some
  1085. corrections, you can post a "superseding" article that will replace
  1086. your original article.
  1087.  
  1088.    Go to the original article and press `S s'
  1089. (`gnus-summary-supersede-article').  You will be put in a buffer where
  1090. you can edit the article all you want before sending it off the usual
  1091. way.
  1092.  
  1093.    The same goes for superseding as for canceling, only more so: Some
  1094. sites do not honor superseding.  On those sites, it will appear that you
  1095. have posted almost the same article twice.
  1096.  
  1097.    If you have just posted the article, and change your mind right away,
  1098. there is a trick you can use to cancel/supersede the article without
  1099. waiting for the article to appear on your site first.  You simply return
  1100. to the post buffer (which is called `*post-buf*').  There you will find
  1101. the article you just posted, with all the headers intact.  Change the
  1102. `Message-ID' header to a `Cancel' or `Supersedes' header by
  1103. substituting one of those words for `Message-ID'.  Then just press `C-c
  1104. C-c' to send the article as you would do normally.  The previous
  1105. article will be canceled/superseded.
  1106.  
  1107.    Just remember, kids: There is no 'c' in 'supersede'.
  1108.  
  1109. 
  1110. File: gnus,  Node: Marking Articles,  Next: Limiting,  Prev: Canceling and Superseding,  Up: The Summary Buffer
  1111.  
  1112. Marking Articles
  1113. ================
  1114.  
  1115.    There are several marks you can set on an article.
  1116.  
  1117.    You have marks that decide the "readedness" (whoo, neato-keano
  1118. neologism ohoy!) of the article.  Alphabetic marks generally mean
  1119. "read", while non-alphabetic characters generally mean "unread".
  1120.  
  1121.    In addition, you also have marks that do not affect readedness.
  1122.  
  1123. * Menu:
  1124.  
  1125. * Unread Articles::      Marks for unread articles.
  1126. * Read Articles::        Marks for read articles.
  1127. * Other Marks::          Marks that do not affect readedness.
  1128.  
  1129.    There's a plethora of commands for manipulating these marks:
  1130.  
  1131. * Menu:
  1132.  
  1133. * Setting Marks::           How to set and remove marks.
  1134. * Setting Process Marks::   How to mark articles for later processing.
  1135.  
  1136. 
  1137. File: gnus,  Node: Unread Articles,  Next: Read Articles,  Up: Marking Articles
  1138.  
  1139. Unread Articles
  1140. ---------------
  1141.  
  1142.    The following marks mark articles as unread, in one form or other.
  1143.  
  1144. `!'
  1145.      "Ticked articles" are articles that will remain visible always.  If
  1146.      you see an article that you find interesting, or you want to put
  1147.      off reading it, or replying to it, until sometime later, you'd
  1148.      typically tick it.  However, articles can be expired, so if you
  1149.      want to keep an article forever, you'll have to save it.  Ticked
  1150.      articles have a `!' (`gnus-ticked-mark') in the first column.
  1151.  
  1152. `?'
  1153.      A "dormant" article is marked with a `?' (`gnus-dormant-mark'),
  1154.      and will only appear in the summary buffer if there are followups
  1155.      to it.
  1156.  
  1157. `SPACE'
  1158.      An "unread" article is marked with a `SPACE' (`gnus-unread-mark').
  1159.      These are articles that haven't been read at all yet.
  1160.  
  1161. 
  1162. File: gnus,  Node: Read Articles,  Next: Other Marks,  Prev: Unread Articles,  Up: Marking Articles
  1163.  
  1164. Read Articles
  1165. -------------
  1166.  
  1167.    All the following marks mark articles as read.
  1168.  
  1169. `r'
  1170.      Articles that are marked as read.  They have a `r'
  1171.      (`gnus-del-mark') in the first column.  These are articles that the
  1172.      user has marked as read more or less manually.
  1173.  
  1174. `R'
  1175.      Articles that are actually read are marked with `R'
  1176.      (`gnus-read-mark').
  1177.  
  1178. `O'
  1179.      Articles that were marked as read in previous sessions are now
  1180.      "old" and marked with `O' (`gnus-ancient-mark').
  1181.  
  1182. `K'
  1183.      Marked as killed (`gnus-killed-mark').
  1184.  
  1185. `X'
  1186.      Marked as killed by kill files (`gnus-kill-file-mark').
  1187.  
  1188. `Y'
  1189.      Marked as read by having a too low score (`gnus-low-score-mark').
  1190.  
  1191. `C'
  1192.      Marked as read by a catchup (`gnus-catchup-mark').
  1193.  
  1194. `G'
  1195.      Canceled article (`gnus-canceled-mark')
  1196.  
  1197. `F'
  1198.      SOUPed article (`gnus-souped-mark').
  1199.  
  1200. `Q'
  1201.      Sparsely reffed article (`gnus-sparse-mark').
  1202.  
  1203.    All these marks just mean that the article is marked as read, really.
  1204. They are interpreted differently by the adaptive scoring scheme,
  1205. however.
  1206.  
  1207.    One more special mark, though:
  1208.  
  1209. `E'
  1210.      You can also mark articles as "expirable" (or have them marked as
  1211.      such automatically).  That doesn't make much sense in normal
  1212.      groups, because a user does not control the expiring of news
  1213.      articles, but in mail groups, for instance, articles that are
  1214.      marked as "expirable" can be deleted by Gnus at any time.
  1215.      Expirable articles are marked with `E' (`gnus-expirable-mark').
  1216.  
  1217. 
  1218. File: gnus,  Node: Other Marks,  Next: Setting Marks,  Prev: Read Articles,  Up: Marking Articles
  1219.  
  1220. Other Marks
  1221. -----------
  1222.  
  1223.    There are some marks that have nothing to do with whether the
  1224. article is read or not.
  1225.  
  1226.    * You can set a bookmark in the current article.  Say you are
  1227.      reading a long thesis on cats' urinary tracts, and have to go home
  1228.      for dinner before you've finished reading the thesis.  You can
  1229.      then set a bookmark in the article, and Gnus will jump to this
  1230.      bookmark the next time it encounters the article.
  1231.  
  1232.    * All articles that you have replied to or made a followup to (i.e.,
  1233.      have answered) will be marked with an `A' in the second column
  1234.      (`gnus-replied-mark').
  1235.  
  1236.    * Articles that are stored in the article cache will be marked with
  1237.      an `*' in the second column (`gnus-cached-mark').
  1238.  
  1239.    * Articles that are "saved" (in some manner or other; not necessarily
  1240.      religiously) are marked with an `S' in the second column
  1241.      (`gnus-saved-mark'.
  1242.  
  1243.    * It the `%e' spec is used, the presence of threads or not will be
  1244.      marked with `gnus-not-empty-thread-mark' and
  1245.      `gnus-empty-thread-mark' in the third column, respectively.
  1246.  
  1247.    * Finally we have the "process mark" (`gnus-process-mark'.  A
  1248.      variety of commands react to the presence of the process mark.  For
  1249.      instance, `X u' (`gnus-uu-decode-uu') will uudecode and view all
  1250.      articles that have been marked with the process mark.  Articles
  1251.      marked with the process mark have a `#' in the second column.
  1252.  
  1253.    You might have noticed that most of these "non-readedness" marks
  1254. appear in the second column by default.  So if you have a cached, saved,
  1255. replied article that you have process-marked, what will that look like?
  1256.  
  1257.    Nothing much.  The precedence rules go as follows: process -> cache
  1258. -> replied -> saved.  So if the article is in the cache and is replied,
  1259. you'll only see the cache mark and not the replied mark.
  1260.  
  1261. 
  1262. File: gnus,  Node: Setting Marks,  Next: Setting Process Marks,  Prev: Other Marks,  Up: Marking Articles
  1263.  
  1264. Setting Marks
  1265. -------------
  1266.  
  1267.    All the marking commands understand the numeric prefix.
  1268.  
  1269. `M t'
  1270. `!'
  1271.      Tick the current article (`gnus-summary-tick-article-forward').
  1272.  
  1273. `M ?'
  1274. `?'
  1275.      Mark the current article as dormant
  1276.      (`gnus-summary-mark-as-dormant').
  1277.  
  1278. `M d'
  1279. `d'
  1280.      Mark the current article as read
  1281.      (`gnus-summary-mark-as-read-forward').
  1282.  
  1283. `M k'
  1284. `k'
  1285.      Mark all articles that have the same subject as the current one as
  1286.      read, and then select the next unread article
  1287.      (`gnus-summary-kill-same-subject-and-select').
  1288.  
  1289. `M K'
  1290. `C-k'
  1291.      Mark all articles that have the same subject as the current one as
  1292.      read (`gnus-summary-kill-same-subject').
  1293.  
  1294. `M C'
  1295.      Mark all unread articles in the group as read
  1296.      (`gnus-summary-catchup').
  1297.  
  1298. `M C-c'
  1299.      Mark all articles in the group as read--even the ticked and dormant
  1300.      articles (`gnus-summary-catchup-all').
  1301.  
  1302. `M H'
  1303.      Catchup the current group to point
  1304.      (`gnus-summary-catchup-to-here').
  1305.  
  1306. `C-w'
  1307.      Mark all articles between point and mark as read
  1308.      (`gnus-summary-mark-region-as-read').
  1309.  
  1310. `M V k'
  1311.      Kill all articles with scores below the default score (or below the
  1312.      numeric prefix) (`gnus-summary-kill-below').
  1313.  
  1314. `M c'
  1315. `M-u'
  1316.      Clear all readedness-marks from the current article
  1317.      (`gnus-summary-clear-mark-forward').
  1318.  
  1319. `M e'
  1320. `E'
  1321.      Mark the current article as expirable
  1322.      (`gnus-summary-mark-as-expirable').
  1323.  
  1324. `M b'
  1325.      Set a bookmark in the current article
  1326.      (`gnus-summary-set-bookmark').
  1327.  
  1328. `M B'
  1329.      Remove the bookmark from the current article
  1330.      (`gnus-summary-remove-bookmark').
  1331.  
  1332. `M V c'
  1333.      Clear all marks from articles with scores over the default score
  1334.      (or over the numeric prefix) (`gnus-summary-clear-above').
  1335.  
  1336. `M V u'
  1337.      Tick all articles with scores over the default score (or over the
  1338.      numeric prefix) (`gnus-summary-tick-above').
  1339.  
  1340. `M V m'
  1341.      Prompt for a mark, and mark all articles with scores over the
  1342.      default score (or over the numeric prefix) with this mark
  1343.      (`gnus-summary-clear-above').
  1344.  
  1345.    The `gnus-summary-goto-unread' variable controls what action should
  1346. be taken after setting a mark.  If non-`nil', point will move to the
  1347. next/previous unread article.  If `nil', point will just move one line
  1348. up or down.  As a special case, if this variable is `never', all the
  1349. marking commands as well as other commands (like `SPACE') will move to
  1350. the next article, whether it is unread or not.  The default is `t'.
  1351.  
  1352. 
  1353. File: gnus,  Node: Setting Process Marks,  Prev: Setting Marks,  Up: Marking Articles
  1354.  
  1355. Setting Process Marks
  1356. ---------------------
  1357.  
  1358. `M P p'
  1359. `#'
  1360.      Mark the current article with the process mark
  1361.      (`gnus-summary-mark-as-processable').
  1362.  
  1363. `M P u'
  1364. `M-#'
  1365.      Remove the process mark, if any, from the current article
  1366.      (`gnus-summary-unmark-as-processable').
  1367.  
  1368. `M P U'
  1369.      Remove the process mark from all articles
  1370.      (`gnus-summary-unmark-all-processable').
  1371.  
  1372. `M P R'
  1373.      Mark articles by a regular expression (`gnus-uu-mark-by-regexp').
  1374.  
  1375. `M P r'
  1376.      Mark articles in region (`gnus-uu-mark-region').
  1377.  
  1378. `M P t'
  1379.      Mark all articles in the current (sub)thread
  1380.      (`gnus-uu-mark-thread').
  1381.  
  1382. `M P T'
  1383.      Unmark all articles in the current (sub)thread
  1384.      (`gnus-uu-unmark-thread').
  1385.  
  1386. `M P v'
  1387.      Mark all articles that have a score above the prefix argument
  1388.      (`gnus-uu-mark-over').
  1389.  
  1390. `M P s'
  1391.      Mark all articles in the current series (`gnus-uu-mark-series').
  1392.  
  1393. `M P S'
  1394.      Mark all series that have already had some articles marked
  1395.      (`gnus-uu-mark-sparse').
  1396.  
  1397. `M P a'
  1398.      Mark all articles in series order (`gnus-uu-mark-series').
  1399.  
  1400. `M P b'
  1401.      Mark all articles in the buffer in the order they appear
  1402.      (`gnus-uu-mark-buffer').
  1403.  
  1404. 
  1405. File: gnus,  Node: Limiting,  Next: Threading,  Prev: Marking Articles,  Up: The Summary Buffer
  1406.  
  1407. Limiting
  1408. ========
  1409.  
  1410.    It can be convenient to limit the summary buffer to just show some
  1411. subset of the articles currently in the group.  The effect most limit
  1412. commands have is to remove a few (or many) articles from the summary
  1413. buffer.
  1414.  
  1415. `/ /'
  1416. `/ s'
  1417.      Limit the summary buffer to articles that match some subject
  1418.      (`gnus-summary-limit-to-subject').
  1419.  
  1420. `/ a'
  1421.      Limit the summary buffer to articles that match some author
  1422.      (`gnus-summary-limit-to-author').
  1423.  
  1424. `/ u'
  1425. `x'
  1426.      Limit the summary buffer to articles that are not marked as read
  1427.      (`gnus-summary-limit-to-unread').  If given a prefix, limit the
  1428.      buffer to articles that are strictly unread.  This means that
  1429.      ticked and dormant articles will also be excluded.
  1430.  
  1431. `/ m'
  1432.      Ask for a mark and then limit to all articles that have not been
  1433.      marked with that mark (`gnus-summary-limit-to-marks').
  1434.  
  1435. `/ n'
  1436.      Limit the summary buffer to the current article
  1437.      (`gnus-summary-limit-to-articles').  Uses the process/prefix
  1438.      convention (*note Process/Prefix::.).
  1439.  
  1440. `/ w'
  1441.      Pop the previous limit off the stack and restore it
  1442.      (`gnus-summary-pop-limit').  If given a prefix, pop all limits off
  1443.      the stack.
  1444.  
  1445. `/ v'
  1446.      Limit the summary buffer to articles that have a score at or above
  1447.      some score (`gnus-summary-limit-to-score').
  1448.  
  1449. `/ E'
  1450. `M S'
  1451.      Display all expunged articles
  1452.      (`gnus-summary-limit-include-expunged').
  1453.  
  1454. `/ D'
  1455.      Display all dormant articles
  1456.      (`gnus-summary-limit-include-dormant').
  1457.  
  1458. `/ d'
  1459.      Hide all dormant articles (`gnus-summary-limit-exclude-dormant').
  1460.  
  1461. `/ c'
  1462.      Hide all dormant articles that have no children
  1463.      (`gnus-summary-limit-exclude-childless-dormant').
  1464.  
  1465. `/ C'
  1466.      Mark all excluded unread articles as read
  1467.      (`gnus-summary-limit-mark-excluded-as-read').   If given a prefix,
  1468.      also mark excluded ticked and dormant articles as read.
  1469.  
  1470. 
  1471. File: gnus,  Node: Threading,  Next: Sorting,  Prev: Limiting,  Up: The Summary Buffer
  1472.  
  1473. Threading
  1474. =========
  1475.  
  1476.    Gnus threads articles by default.  "To thread" is to put replies to
  1477. articles directly after the articles they reply to--in a hierarchical
  1478. fashion.
  1479.  
  1480. * Menu:
  1481.  
  1482. * Customizing Threading::     Variables you can change to affect the threading.
  1483. * Thread Commands::           Thread based commands in the summary buffer.
  1484.  
  1485.